Skip to main content

5. Mark WhatsApp Message as Read

This section describes the process for marking a WhatsApp message as read within the ViSN platform. This operation is triggered when a user opens the chat drawer under certain conditions, and it ensures that the unread message count is updated and the message status is marked as read via the WhatsApp API.

1. Triggering the Callable Endpoint​

The callable endpoint enquiry/markWhatsappMessageAsRead is invoked when:

  • User Interaction:
    The user opens the chat drawer.
  • Unread Message Check:
    The unread whatsapp message count enquiry.unReadWhatsappMessageCount is greater than 0.
  • Ownership Conditions:
    Either the enquiry is not owned by any user or it is owned by the current user.

2. Callable Endpoint Functionality​

Upon invocation, the callable endpoint performs the following actions:

  • Enqueue Cloud Task:
    It adds a task to the whatsapp-messages-queue with the following details:

    • Task Data:
      • timestamp: Current date and time.
      • type: MARK_WHATSAPP_MESSAGE_AS_READ .
      • ETA: 0
      • Payload:
        • enquiryId
        • accountId
        • serviceUnitId
        • leaseId
        • leaseWhatsappDetails

3. Processing in Queue Services​

The enqueued task is later processed by the whatsapp/markMessageAsRead endpoint in the queue-services, which executes the following steps:

Retrieve Latest Message ID​

  • The service fetches the latest message ID that originated from the driver.

Call WhatsApp API​

  • The service calls the WhatsApp API to mark messages as read using the appropriate token and phone number ID with the following request body: 
    const body = {
      messaging_product: 'whatsapp',
      status: 'read',
      message_id: whatsappMessageId,
    };

    Note: The WhatsApp API only requires the latest message ID (i.e., whatsappMessageId) to mark all unread messages as read.

Update Firestore Document​

  • The service updates the unReadWhatsappMessageCount in the lease enquiry document: /leasecompany/{leaseId}/enquiries/{enquiryId}

Logging and Monitoring​

  • Logs are generated to record:
    • The API call to WhatsApp.
    • Any relevant details for debugging.
Status: Draft (Pending Review)
Category: Protected
Authored By: Sohan on March 04, 2025